ODBC Driver程序员指南

关于本出版物

本简介概述了本出版物中的信息，并描述了所使用的约定。

本手册作为 GBase 8s ODBC Driver 的用户指南和参考，这是 Microsoft™“开放数据库互连”（ODBC）接口 Version 3.0 的 GBase 8s 实现。

本手册说明如何使用 GBase 8s ODBC Driver 应用程序编程接口（API），来访问 GBase 8s 数据库，并与 GBase 8s 数据库服务器交互。

本文档是为 C 编程人员编写的，他们使用 GBase 8s ODBC Driver 来访问 GBase 8s 数据库。

这些主题假定您具有下列背景：

使用计算机、操作系统和操作系统提供的实用程序的知识
使用关系型或对象-关系型数据库的一定经验，或接触过关系数据库概念
C 编程语言

要了解关于软件兼容性的信息，请参阅 GBase 8s Client SDK 发版说明。

这些主题出自《GBase 8s ODBC Driver 程序员指南》。

符合行业标准

GBase 8s 产品符合各种标准。

基于 SQL 的 GBase 8s 产品完全兼容 SQL-92 入门级（发布为 ANSI X3.135-1992），这与 ISO 9075:1992 完全相同。另外， GBase 8s 数据库服务器的许多功能都遵守 SQL-92 中级和完全级别以及 X/Open SQL 公共应用程序环境 (CAE) 标准。

演示数据库

DB-Access 实用程序随 GBase 8s 数据库服务器产品一起提供，它包括一个或多个以下演示数据库：

stores_demo 数据库以一家虚构的体育用品批发商的有关信息举例说明了关系模式。GBase 8s 出版物中的许多示例均基于 stores_demo 数据库。
superstores_demo 数据库举例说明了对象关系模式。superstores_demo 数据库包含扩展数据类型、类型和表继承以及用户定义的例程的示例。

有关如何创建和填充演示数据库的信息，请参阅《GBase 8s DB-Access 用户指南》。有关数据库及其内容的描述，请参阅《GBase 8s SQL 指南：参考》。

用于安装演示数据库的脚本位于 UNIX™ 平台上的 $GBS_HOME/bin 目录和 Windows™ 环境中的 %GBS_HOME%\bin 目录中。

示例代码约定

SQL 代码的示例在整个出版物中出现。除非另有说明，代码不特定于任何单个的 GBase 8s 应用程序开发工具。

如果示例中仅列出 SQL 语句，那么它们将不用分号定界。例如：您可能看到以下示例中的代码：

CONNECT TO stores_demo
...
DELETE FROM customer
WHERE customer_num = 121
...
COMMIT WORK
DISCONNECT CURRENT

要将此 SQL 代码用于特定产品，必须应用该产品的语法规则。例如，如果使用的是 SQL API，那么必须在每条语句的开头使用 EXEC SQL，并在每条语句的结尾使用分号（或其他合适的定界符）。如果使用的是 DB–Access，那么必须用分号将多条语句隔开。

提示

代码示例中的省略点表示在整个应用程序中将添加更多的代码，但是不必显示它以描述正在讨论的概念。

有关使用特定应用程序开发工具或 SQL API 的 SQL 语句的详细指导，请参阅您的产品文档。

语法图

语法图使用特殊组件描述语句和命令的语法。

如何阅读命令行语法图

命令行语法图使用类似于其他语法图元素的元素。

某些元素列于语法图中的表中。

创建非转换作业

此图中有一个名为“设置运行方式”的段，根据图脚注，这个段在第 Z-1 页上。如果这是真正的交叉引用，那么您可以在附录 Z 的第一页上找到此段。但在此处，此段显示在以下段图表中。请注意：该图使用段开头和结束部分。

设置运行方式

要了解如何正确构造命令，请从主图的左上角开始。遵循右边的图表，包括想要的元素。此图中的元素区分大小写，因为它们说明实用程序的语法。其他类型的语法（例如 SQL）则不区分大小写。

“创建非转换作业”图表说明了以下步骤：

输入 onpladm create job，然后输入作业的名称。
或者，输入 -p，然后输入项目的名称。
输入以下所需的元素：
- -n
- -d 和设备的名称
- -D 和数据库的名称
- -t 和表的名称
或者，可以选择一个或多个以下元素并重复它们任意次：
- -S 和服务器名称
- -T 和目标服务器名称
- 运行方式。要设置运行方式，请遵循“设置运行方式”段图表来输入 -f，或者输入 d、p 或 a，然后可选择输入 l 或 u。
遵循图表直至终止符。